package com.itcam.otcbackend.service.impl;

import cn.hutool.core.bean.BeanUtil;
import cn.hutool.core.collection.CollUtil;
import cn.hutool.core.util.ObjUtil;
import cn.hutool.core.util.ObjectUtil;
import cn.hutool.core.util.StrUtil;
import cn.hutool.json.JSONUtil;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.itcam.otcbackend.api.aliyunai.AliYunAiApi;
import com.itcam.otcbackend.api.aliyunai.model.CreateOutPaintingTaskRequest;
import com.itcam.otcbackend.api.aliyunai.model.CreateOutPaintingTaskResponse;
import com.itcam.otcbackend.api.aliyunai.model.CreatePictureOutPaintingTaskRequest;
import com.itcam.otcbackend.enums.ErrorCode;
import com.itcam.otcbackend.enums.PictureReviewStatusEnum;
import com.itcam.otcbackend.exception.BusinessException;
import com.itcam.otcbackend.manager.CosManager;
import com.itcam.otcbackend.manager.FileManager;
import com.itcam.otcbackend.model.po.Space;
import com.itcam.otcbackend.service.SpaceService;
import com.itcam.otcbackend.template.upload.FilePictureUpload;
import com.itcam.otcbackend.template.upload.PictureUploadTemplate;
import com.itcam.otcbackend.model.dto.file.UploadPictureResult;
import com.itcam.otcbackend.model.dto.picture.*;
import com.itcam.otcbackend.model.po.Picture;
import com.itcam.otcbackend.model.po.User;
import com.itcam.otcbackend.model.vo.PictureVO;
import com.itcam.otcbackend.model.vo.UserVO;
import com.itcam.otcbackend.service.UserService;
import com.itcam.otcbackend.template.upload.UrlPictureUpload;
import com.itcam.otcbackend.utils.ColorSimilarUtils;
import com.itcam.otcbackend.utils.ThrowUtils;
import com.itcam.otcbackend.service.PictureService;
import com.itcam.otcbackend.mapper.PictureMapper;
import lombok.extern.slf4j.Slf4j;
import org.jsoup.Jsoup;
import org.jsoup.nodes.Document;
import org.jsoup.nodes.Element;
import org.jsoup.select.Elements;
import org.springframework.beans.BeanUtils;
import org.springframework.scheduling.annotation.Async;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.transaction.support.TransactionTemplate;

import javax.annotation.Resource;
import javax.servlet.http.HttpServletRequest;
import java.awt.*;
import java.io.IOException;
import java.util.*;
import java.util.List;
import java.util.stream.Collectors;

/**
 * @author Cammy
 * @description 针对表【picture(图片)】的数据库操作Service实现
 * @createDate 2025-02-21 04:13:36
 */
@Service
@Slf4j
public class PictureServiceImpl extends ServiceImpl<PictureMapper, Picture>
        implements PictureService {

    @Resource
    private UserService userService;

    @Resource
    private FileManager fileManager;

    @Resource
    private CosManager cosManager;

    @Resource
    private FilePictureUpload filePictureUpload;

    @Resource
    private UrlPictureUpload urlPictureUpload;

    @Resource
    private SpaceService spaceService;

    @Resource
    private TransactionTemplate transactionTemplate;

    @Resource
    private AliYunAiApi aliYunAiApi;


    /**
     * todo 上传图片
     * 该方法用于处理图片的上传操作，支持新增和更新图片。
     * 上传前会进行一系列的校验，包括图片是否为空、用户是否登录、空间是否存在、用户是否有空间权限、空间额度是否充足等。
     * 根据输入源的类型选择不同的上传方式，最后将图片信息保存或更新到数据库中。
     *
     * @param inputSource 图片输入源，可以是文件对象或图片 URL
     * @param pictureUploadRequest 图片上传请求对象，包含图片的相关信息
     * @param loginUser 当前登录的用户信息
     * @return 上传成功后返回封装好的图片信息对象
     */
    @Override
    public PictureVO uploadPicture(Object inputSource, PictureUploadRequest pictureUploadRequest, User loginUser) {
        // 检查图片输入源是否为空
        if (null == inputSource) {
            throw new BusinessException(ErrorCode.PARAMS_ERROR, "图片为空");
        }

        // 检查用户是否登录
        ThrowUtils.throwIf(loginUser == null, ErrorCode.NOT_LOGIN_ERROR);
        // 从图片上传请求中获取空间 ID
        Long spaceId = pictureUploadRequest.getSpaceId();
        // 如果空间 ID 不为空，进行空间相关校验
        if (null != spaceId) {
            // 根据空间 ID 获取空间信息
            Space space = spaceService.getById(spaceId);
            // 检查空间是否存在
            ThrowUtils.throwIf(space == null, ErrorCode.NOT_FOUND_ERROR, "空间不存在");
//            // 检查用户是否为空间创建人（管理员），只有创建人才能上传
//            if (!loginUser.getId().equals(space.getUserId())) {
//                throw new BusinessException(ErrorCode.NO_AUTH_ERROR, "没有空间权限");
//            }
            // 检查空间的图片数量是否达到上限
            if (space.getTotalCount() >= space.getMaxCount()) {
                throw new BusinessException(ErrorCode.OPERATION_ERROR, "空间条数不足");
            }
            // 检查空间的存储大小是否达到上限
            if (space.getTotalSize() >= space.getMaxSize()) {
                throw new BusinessException(ErrorCode.OPERATION_ERROR, "空间大小不足");
            }
        }
        // 用于判断是新增还是更新图片，初始化为 null
        Long pictureId = null;
        // 如果图片上传请求对象不为空，获取图片 ID
        if (pictureUploadRequest != null) {
            pictureId = pictureUploadRequest.getId();
        }
        // 如果图片 ID 不为空，说明是更新图片，进行相关校验
        if (null != pictureId) {
//            boolean exists = this.lambdaQuery()
//                    .eq(Picture::getId, pictureId)
//                    .exists();
//            ThrowUtils.throwIf(!exists, ErrorCode.NOT_FOUND_ERROR, "图片不存在");
            // 根据图片 ID 获取旧的图片信息
            Picture oldPicture = this.getById(pictureId);
            // 检查旧图片是否存在
            ThrowUtils.throwIf(null == oldPicture, ErrorCode.NOT_FOUND_ERROR, "图片不存在");
//            // 检查用户是否为图片所有者或管理员，只有本人或管理员可编辑
//            if (!oldPicture.getUserId().equals(loginUser.getId()) && !userService.isAdmin(loginUser)) {
//                throw new BusinessException(ErrorCode.NO_AUTH_ERROR);
//            }
            // 校验空间是否一致
            // 如果没有传入空间 ID，则复用原有图片的空间 ID
            if (null == spaceId) {
                if (null != oldPicture.getSpaceId()) {
                    spaceId = oldPicture.getSpaceId();
                }
            } else {
                // 如果传入了空间 ID，必须和原有图片的空间 ID 一致
                if (ObjectUtil.notEqual(spaceId, oldPicture.getSpaceId())) {
                    throw new BusinessException(ErrorCode.PARAMS_ERROR, "空间id不一致");
                }
            }
        }
        // 上传图片，得到信息
        // 按照用户 ID 划分目录 --> 按照空间划分目录
        String uploadPathPrefix;
        // 如果空间 ID 为空，上传到公共目录
        if (spaceId == null) {
            uploadPathPrefix = String.format("public/%s", loginUser.getId());
        } else {
            // 如果空间 ID 不为空，上传到指定空间目录
            uploadPathPrefix = String.format("space/%s", loginUser.getId());
        }
        // 根据输入源的类型选择不同的上传方式
        PictureUploadTemplate pictureUploadTemplate = filePictureUpload;
        // 如果输入源是字符串，说明是图片 URL，使用 URL 上传方式
        if (inputSource instanceof String) {
            pictureUploadTemplate = urlPictureUpload;
        }
        // 调用上传模板的方法上传图片，并获取上传结果
        UploadPictureResult uploadPictureResult = pictureUploadTemplate.uploadPicture(inputSource, uploadPathPrefix);
        // 构造要入库的图片信息
        Picture picture = new Picture();
        // 设置图片的 URL
        picture.setUrl(uploadPictureResult.getUrl());
        // 设置图片所属的空间 ID
        picture.setSpaceId(spaceId);
        // 获取主色调
        picture.setPicColor(uploadPictureResult.getPicColor());
        // 获取图片的名称，优先使用上传请求中的名称
        String picName = uploadPictureResult.getPicName();
        if (pictureUploadRequest != null && StrUtil.isNotBlank(pictureUploadRequest.getPicName())) {
            picName = pictureUploadRequest.getPicName();
        }
        // 设置图片的名称
        picture.setName(picName);

        // 设置图片的格式
        picture.setPicFormat(uploadPictureResult.getPicFormat());
        // 设置图片的所有者用户 ID
        picture.setUserId(loginUser.getId());
        // 补充审核参数，根据用户角色设置审核状态
        fillReviewParams(picture, loginUser);
        // 如果图片 ID 不为空，表示更新操作，需要补充 ID 和编辑时间
        if (null != pictureId) {
            // 设置图片的 ID
            picture.setId(pictureId);
            // 设置图片的编辑时间
            picture.setEditTime(new Date());
        }
//        // 如果不是更新操作，那么就是新增操作，保存或更新图片信息到数据库
//        boolean result = this.saveOrUpdate(picture);
//        // 检查保存或更新操作是否成功
//        ThrowUtils.throwIf(!result, ErrorCode.OPERATION_ERROR, "图片上传失败");
        // 开启事务，确保图片上传和空间额度更新操作的原子性
        Long finalSpaceId = spaceId;
        // 使用事务模板来执行一系列数据库操作，确保在事务中执行
        transactionTemplate.execute(status -> {
            // 尝试保存或更新图片信息到数据库
            boolean result = this.saveOrUpdate(picture);
            // 若保存或更新操作失败，抛出业务异常
            ThrowUtils.throwIf(!result, ErrorCode.OPERATION_ERROR, "图片上传失败");
            // 如果空间 ID 不为空，需要更新对应空间的使用额度
            if (finalSpaceId != null) {
                // 执行空间额度更新操作，增加空间的总大小和图片数量
                boolean update = spaceService.lambdaUpdate()
                        // 根据空间 ID 定位要更新的空间记录
                        .eq(Space::getId, finalSpaceId)
                        // 增加空间的总使用大小
                        .setSql("totalSize = totalSize + " + picture.getPicSize())
                        // 增加空间内图片的总数
                        .setSql("totalCount = totalCount + 1")
                        // 执行更新操作
                        .update();
                // 若空间额度更新操作失败，抛出业务异常
                ThrowUtils.throwIf(!update, ErrorCode.OPERATION_ERROR, "额度更新失败");
            }
            // 返回保存或更新后的图片对象
            return picture;
        });

        // 将图片信息对象转换为封装好的视图对象并返回
        return PictureVO.objToVo(picture);
    }


    /**
     * todo 将查询请求转为QueryWrapper对象
     * @param pictureQueryRequest 图片查询请求对象
     * @return 构建好的QueryWrapper对象
     * 以下代码需要注意两点：
     *  searchText支持同时从name和introduction中检索，可以用queryWrapper的or语法构造查询条件
     *  由于tags在数据库中存储的是JSON格式的字符串，如果前端要传多个tag（必须同时存在才查出），需要遍历tags数组，每个标签都是用like模糊查询，将这些条件组合在一起
     */
    @Override
    public QueryWrapper<Picture> getQueryWrapper(PictureQueryRequest pictureQueryRequest) {
        // 创建新的QueryWrapper对象
        QueryWrapper<Picture> queryWrapper = new QueryWrapper<>();
        // 如果查询请求为空，直接返回空的QueryWrapper
        if (pictureQueryRequest == null) {
            return queryWrapper;
        }
        // 从查询请求对象中获取各个查询条件
        Long id = pictureQueryRequest.getId();
        String name = pictureQueryRequest.getName();
        String introduction = pictureQueryRequest.getIntroduction();
        String category = pictureQueryRequest.getCategory();
        List<String> tags = pictureQueryRequest.getTags();
        Long picSize = pictureQueryRequest.getPicSize();
        Integer picWidth = pictureQueryRequest.getPicWidth();
        Integer picHeight = pictureQueryRequest.getPicHeight();
        Double picScale = pictureQueryRequest.getPicScale();
        String picFormat = pictureQueryRequest.getPicFormat();
        String searchText = pictureQueryRequest.getSearchText();
        Long userId = pictureQueryRequest.getUserId();
        String sortField = pictureQueryRequest.getSortField();
        String sortOrder = pictureQueryRequest.getSortOrder();
        Long reviewerId = pictureQueryRequest.getReviewerId();
        Integer reviewStatus = pictureQueryRequest.getReviewStatus();
        String reviewMessage = pictureQueryRequest.getReviewMessage();
        Long spaceId = pictureQueryRequest.getSpaceId();
        boolean nullSpaceId = pictureQueryRequest.isNullSpaceId();
        Date startEditTime = pictureQueryRequest.getStartEditTime();
        Date endEditTime = pictureQueryRequest.getEndEditTime();

        // 处理模糊搜索条件
        if (StrUtil.isNotBlank(searchText)) {
            // 在name和introduction字段中进行模糊搜索
            queryWrapper.and(qw -> qw.like("name", searchText)
                    .or()
                    .like("introduction", searchText)
            );
        }
        // 添加各个字段的精确查询条件
        queryWrapper.eq(ObjUtil.isNotEmpty(id), "id", id);
        queryWrapper.eq(ObjUtil.isNotEmpty(userId), "userId", userId);
        queryWrapper.like(StrUtil.isNotBlank(name), "name", name);
        queryWrapper.like(StrUtil.isNotBlank(introduction), "introduction", introduction);
        queryWrapper.like(StrUtil.isNotBlank(picFormat), "picFormat", picFormat);
        queryWrapper.eq(StrUtil.isNotBlank(category), "category", category);
        queryWrapper.eq(ObjUtil.isNotEmpty(picWidth), "picWidth", picWidth);
        queryWrapper.eq(ObjUtil.isNotEmpty(picHeight), "picHeight", picHeight);
        queryWrapper.eq(ObjUtil.isNotEmpty(picSize), "picSize", picSize);
        queryWrapper.eq(ObjUtil.isNotEmpty(picScale), "picScale", picScale);
        queryWrapper.eq(ObjectUtil.isNotEmpty(reviewerId), "reviewId", reviewerId);
        queryWrapper.eq(ObjUtil.isNotEmpty(reviewStatus), "reviewStatus", reviewStatus);
        queryWrapper.like(ObjectUtil.isNotEmpty(reviewMessage), "reviewMessage", reviewMessage);
        queryWrapper.eq(ObjectUtil.isNotEmpty(spaceId), "spaceId", spaceId);
        queryWrapper.isNull(nullSpaceId, "spaceId");
        queryWrapper.ge(ObjUtil.isNotEmpty(startEditTime), "editTime", startEditTime);
        queryWrapper.lt(ObjUtil.isNotEmpty(endEditTime), "editTime", endEditTime);

        // todo:对于目前来说用户正常情况不会得到未过审的图片id，影响面小，可以暂时不做根据id查询接口的限制

        // 处理标签数组查询
        if (CollUtil.isNotEmpty(tags)) {
            for (String tag : tags) {
                // 对每个标签进行模糊查询
                queryWrapper.like("tags", "\"" + tag + "\"");
            }
        }
        // 添加排序条件
        queryWrapper.orderBy(StrUtil.isNotEmpty(sortField), sortOrder.equals("ascend"), sortField);
        return queryWrapper;
    }

    /**
     * 获取单个图片封装
     * @param picture
     * @param request
     * @return
     */
    @Override
    public PictureVO getPictureVO(Picture picture, HttpServletRequest request) {
        // 对象转封装类
        PictureVO pictureVO = PictureVO.objToVo(picture);
        // 关联查询用户信息
        Long userId = picture.getUserId();
        if (userId != null && userId > 0) {
            User user = userService.getById(userId);
            UserVO userVO = userService.getUserVO(user);
            pictureVO.setUser(userVO);
        }
        return pictureVO;
    }

    /**
     * 分页获取图片封装
     * @param picturePage 包含图片实体对象的分页对象
     * @param request HTTP请求对象
     * @return 包含图片VO对象的分页对象
     */
    @Override
    public Page<PictureVO> getPictureVOPage(Page<Picture> picturePage, HttpServletRequest request) {
        // 获取当前页的图片列表
        List<Picture> pictureList = picturePage.getRecords();
        // 创建新的VO分页对象，继承原分页参数
        Page<PictureVO> pictureVOPage = new Page<>(picturePage.getCurrent(), picturePage.getSize(), picturePage.getTotal());
        // 如果图片列表为空，直接返回空的分页对象
        if (CollUtil.isEmpty(pictureList)) {
            return pictureVOPage;
        }
        // 将Picture对象列表转换为PictureVO对象列表
        List<PictureVO> pictureVOList = pictureList.stream().map(PictureVO::objToVo).collect(Collectors.toList());
        // 1. 获取所有图片关联的用户ID集合
        Set<Long> userIdSet = pictureList.stream().map(Picture::getUserId).collect(Collectors.toSet());
        // 根据用户ID集合查询用户信息，并按用户ID分组
        Map<Long, List<User>> userIdUserListMap = userService.listByIds(userIdSet).stream()
                .collect(Collectors.groupingBy(User::getId));
        // 2. 为每个PictureVO对象填充用户信息
        pictureVOList.forEach(pictureVO -> {
            Long userId = pictureVO.getUserId();
            User user = null;
            // 如果存在对应的用户信息
            if (userIdUserListMap.containsKey(userId)) {
                // 获取第一个用户（因为按ID分组，每个ID对应一个用户）
                user = userIdUserListMap.get(userId).get(0);
            }
            // 设置用户VO信息
            pictureVO.setUser(userService.getUserVO(user));
        });
        // 设置VO分页对象的记录
        pictureVOPage.setRecords(pictureVOList);
        return pictureVOPage;
    }

    /**
     * 图片数据校验——用于更新和修改图片时进行判断
     * @param picture
     */
    @Override
    public void validPicture(Picture picture) {
        ThrowUtils.throwIf(picture == null, ErrorCode.PARAMS_ERROR);
        // 从对象中取值
        Long id = picture.getId();
        String url = picture.getUrl();
        String introduction = picture.getIntroduction();
        // 修改数据时，id 不能为空，有参数则校验
        ThrowUtils.throwIf(ObjUtil.isNull(id), ErrorCode.PARAMS_ERROR, "id 不能为空");
        if (StrUtil.isNotBlank(url)) {
            ThrowUtils.throwIf(url.length() > 1024, ErrorCode.PARAMS_ERROR, "url 过长");
        }
        if (StrUtil.isNotBlank(introduction)) {
            ThrowUtils.throwIf(introduction.length() > 800, ErrorCode.PARAMS_ERROR, "简介过长");
        }
    }

    /**
     * 图片审核
     * @param pictureReviewRequest
     * @param loginUser
     */
    @Override
    public void doPictureReview(PictureReviewRequest pictureReviewRequest, User loginUser) {
        Long id = pictureReviewRequest.getId();
        Integer reviewStatus = pictureReviewRequest.getReviewStatus();
        PictureReviewStatusEnum reviewStatusEnum = PictureReviewStatusEnum.getEnumByValue(reviewStatus);
        if (null == id || null == reviewStatusEnum || PictureReviewStatusEnum.REVIEWING.equals(reviewStatusEnum)) {
            throw new BusinessException(ErrorCode.PARAMS_ERROR);
        }
        Picture oldPicture = this.getById(id);
        ThrowUtils.throwIf(null == oldPicture, ErrorCode.NOT_FOUND_ERROR);
        // 已经是该状态
        if (oldPicture.getReviewStatus().equals(reviewStatus)) {
            throw new BusinessException(ErrorCode.PARAMS_ERROR, "请勿重复审核");
        }
        // 更新审核状态
        Picture updatePicture = BeanUtil.copyProperties(pictureReviewRequest, Picture.class);
        updatePicture.setReviewerId(loginUser.getId());
        updatePicture.setReviewTime(new Date());
        boolean result = this.updateById(updatePicture);
        ThrowUtils.throwIf(!result, ErrorCode.OPERATION_ERROR);
    }

    /**
     * 设置审核状态——管理员自动过审并且填充审核参数；用户上传或编辑图片时，图片的状态会被设置为"待审核"
     * @param picture
     * @param loginUser
     */
    @Override
    public void fillReviewParams(Picture picture, User loginUser) {
        if (userService.isAdmin(loginUser)) {
            // 管理员自动过审
            picture.setReviewStatus(PictureReviewStatusEnum.PASS.getValue());
            picture.setReviewerId(loginUser.getId());
            picture.setReviewTime(new Date());
            picture.setReviewMessage("管理员自动过审");
        } else {
            // 非管理员，创建或编辑都要改为“待审核”
            picture.setReviewStatus(PictureReviewStatusEnum.REVIEWING.getValue());
        }
    }

    /**
     * 清理数据
     * @param oldPicture
     */
    @Override
    @Async // 开启异步调用
    public void clearPictureFile(Picture oldPicture) {
        // 判断该图片是否被多条记录使用
        String pictureUrl = oldPicture.getUrl();
        Long count = this.lambdaQuery()
                .eq(Picture::getUrl, pictureUrl)
                .count();
        // 有不止一条记录用到了该图片，不清理
        if (count > 1) {
            return;
        }
        // FIXME 注意，这里的url包含了域名，实际上只要传key值（存储路径）就够了
        cosManager.deleteObject(oldPicture.getThumbnailUrl());
        // 清理缩略图
        String thumbnailUrl = oldPicture.getThumbnailUrl();
        if (StrUtil.isNotBlank(thumbnailUrl)) {
            cosManager.deleteObject(thumbnailUrl);
        }
    }

    /**
     * 批量抓取和创建图片
     * @param pictureUploadByBatchRequest
     * @param loginUser
     * @return
     */
    @Override
    public Integer uploadPictureByBatch(PictureUploadByBatchRequest pictureUploadByBatchRequest, User loginUser) {
        // 参数校验
        String searchText = pictureUploadByBatchRequest.getSearchText();
        // 格式化数量
        Integer count = pictureUploadByBatchRequest.getCount();
        ThrowUtils.throwIf(count > 30, ErrorCode.PARAMS_ERROR, "最多30条");
        // 名称前缀默认等于搜索关键字
        String namePrefix = pictureUploadByBatchRequest.getNamePrefix();
        if (StrUtil.isBlank(namePrefix)) {
            namePrefix = searchText;
        }
        // 要抓取的地址
        String fetchUrl = String.format("https://cn.bing.com/images/async?q=不良人&mmasync=1", searchText);
        Document document;
        try {
            document = Jsoup.connect(fetchUrl).get();
        } catch (IOException e) {
            log.error("获取页面失败", e);
            throw new BusinessException(ErrorCode.OPERATION_ERROR, "获取页面失败");
        }
        Element div = document.getElementsByClass("dgControl").first();
        if (ObjectUtil.isNull(div)) {
            throw new BusinessException(ErrorCode.OPERATION_ERROR, "获取元素失败");
        }
        Elements imgElementList = div.select("img.ming");
        int uploadCount = 0;
        for (Element imgElement : imgElementList) {
            String fileUrl = imgElement.attr("src");
            if (StrUtil.isBlank(fileUrl)) {
                log.info("当前连接为空，已跳过：{}", fileUrl);
                continue;
            }
            // 处理图片上传地址，防止出现转义问题
            int questionMarkIndex = fileUrl.indexOf("?");
            if (questionMarkIndex > -1) {
                fileUrl = fileUrl.substring(0, questionMarkIndex);
            }
            // 上传图片
            PictureUploadRequest pictureUploadRequest = new PictureUploadRequest();
            if (StrUtil.isNotBlank(namePrefix)) {
                // 设置图片名称，序号连续递增
                pictureUploadRequest.setPicName(namePrefix + (uploadCount + 1));
            }
            try {
                PictureVO pictureVO = this.uploadPicture(fileUrl, pictureUploadRequest, loginUser);
                log.info("图片上传成功，id={}", pictureVO.getId());
                uploadCount++;
            } catch (Exception e) {
                log.error("图片上传失败", e);
                continue;
            }
            if (uploadCount >= count) {
                break;
            }
        }

        return 0;
    }

    /**
     * 删除空间图片
     * @param pictureId
     * @param loginUser
     */
    @Override
    public void deletePicture(Long pictureId, User loginUser) {
        ThrowUtils.throwIf(pictureId <= 0, ErrorCode.PARAMS_ERROR);
        ThrowUtils.throwIf(loginUser == null, ErrorCode.NO_AUTH_ERROR);
        // 判断是否存在
        Picture oldPicture = this.getById(pictureId);
        ThrowUtils.throwIf(oldPicture == null, ErrorCode.NOT_FOUND_ERROR);
        // 校验权限
        checkPictureAuth(loginUser, oldPicture);
        // 开启事务，确保删除图片和释放空间额度这两个操作具有原子性，要么都成功，要么都失败
        transactionTemplate.execute(status -> {
            // 操作数据库：根据图片 ID 删除图片记录
            boolean result = this.removeById(pictureId);
            // 若删除操作失败，抛出业务异常，使用 ErrorCode.OPERATION_ERROR 表示操作错误
            ThrowUtils.throwIf(!result, ErrorCode.OPERATION_ERROR);
            // 释放额度：从旧图片对象中获取图片所属的空间 ID
            Long spaceId = oldPicture.getSpaceId();
            // 如果空间 ID 不为空，说明图片属于某个空间，需要更新该空间的使用额度
            if (null != spaceId) {
                // 执行空间额度更新操作，减少空间的总使用大小和图片数量
                boolean update = spaceService.lambdaUpdate()
                        // 根据空间 ID 定位要更新的空间记录
                        .eq(Space::getId, spaceId)
                        // 减少空间的总使用大小，减去当前删除图片的大小
                        .setSql("totalSize = totalSize - " + oldPicture.getPicSize())
                        // 减少空间内图片的总数
                        .setSql("totalCount = totalCount - 1")
                        // 执行更新操作
                        .update();
                // 若空间额度更新操作失败，抛出业务异常，提示额度更新失败
                ThrowUtils.throwIf(!update, ErrorCode.OPERATION_ERROR, "额度更新失败");
            }
            // 事务执行成功，返回 true 表示操作成功
            return true;
        });
        // 异步清理文件
        this.clearPictureFile(oldPicture);
    }

    /**
     * 检查图片操作权限
     * @param loginUser
     * @param picture
     */
    @Override
    public void checkPictureAuth(User loginUser, Picture picture) {
        Long spaceId = picture.getSpaceId();
        Long loginUserId = loginUser.getId();
        if (spaceId == null) {
            // 公共图库，仅本人或管理员可操作
            if (!picture.getUserId().equals(loginUserId) && !userService.isAdmin(loginUser)) {
                throw new BusinessException(ErrorCode.NO_AUTH_ERROR);
            }
        } else {
            // 私有空间，仅空间管理员可操作
            if (!picture.getUserId().equals(loginUserId)) {
                throw new BusinessException(ErrorCode.NO_AUTH_ERROR);
            }
        }
    }

    /**
     * 编辑图片（给用户使用）
     * @param pictureEditRequest
     * @param loginUser
     */
    @Override
    public void editPicture(PictureEditRequest pictureEditRequest, User loginUser) {
        // 在此处将实体类和DTO进行转换
        Picture picture = new Picture();
        BeanUtils.copyProperties(pictureEditRequest, picture);
        // 注意将list转为string
        picture.setTags(JSONUtil.toJsonStr(pictureEditRequest.getTags()));
        // 设置编辑时间
        picture.setEditTime(new Date());
        // 数据校验
        this.validPicture(picture);
        // 判断是否存在
        long id = pictureEditRequest.getId();
        Picture oldPicture = this.getById(id);
        ThrowUtils.throwIf(oldPicture == null, ErrorCode.NOT_FOUND_ERROR);
        // 校验权限，以及改为使用注解鉴权
        checkPictureAuth(loginUser, oldPicture);
        // 补充审核参数
        this.fillReviewParams(picture, loginUser);
        // 操作数据库
        boolean result = this.updateById(picture);
        ThrowUtils.throwIf(!result, ErrorCode.OPERATION_ERROR);
    }

    /**
     * todo 按颜色搜索图片
     *
     * @param spaceId 搜索图片的空间ID，用于指定搜索范围
     * @param picColor 目标图片颜色，以十六进制字符串表示，如 "#FF0000"
     * @param loginUser 当前登录的用户信息，用于权限验证
     * @return 返回符合条件的图片列表，以 PictureVO 对象列表形式返回
     */
    @Override
    public List<PictureVO> searchPictureByColor(Long spaceId, String picColor, User loginUser) {
        // 1. 校验参数
        // 检查 spaceId 是否为空，以及 picColor 是否为空字符串
        ThrowUtils.throwIf(spaceId == null || StrUtil.isBlank(picColor), ErrorCode.PARAMS_ERROR);
        // 检查当前登录用户是否为空
        ThrowUtils.throwIf(loginUser == null, ErrorCode.NO_AUTH_ERROR);
        // 2. 校验空间权限
        // 根据 spaceId 获取空间信息
        Space space = spaceService.getById(spaceId);
        // 检查空间是否存在
        ThrowUtils.throwIf(space == null, ErrorCode.NOT_FOUND_ERROR, "空间不存在");
        // 检查当前登录用户是否有访问该空间的权限
        if (!loginUser.getId().equals(space.getUserId())) {
            throw new BusinessException(ErrorCode.NO_AUTH_ERROR, "没有空间访问权限");
        }
        // 3. 查询该空间下所有图片（必须有主色调）
        // 使用 LambdaQueryWrapper 查询该空间下所有有主色调的图片
        List<Picture> pictureList = this.lambdaQuery()
                .eq(Picture::getSpaceId, spaceId)
                .isNotNull(Picture::getPicColor)
                .list();
        // 如果没有图片，直接返回空列表
        if (CollUtil.isEmpty(pictureList)) {
            return Collections.emptyList();
        }
        // 将目标颜色转为 Color 对象
        Color targetColor = Color.decode(picColor);
        // 4. 计算相似度并排序
        // 使用 Stream API 对图片列表进行排序，根据图片主色调与目标颜色的相似度进行排序
        List<Picture> sortedPictures = pictureList.stream()
                .sorted(Comparator.comparingDouble(picture -> {
                    // 提取图片主色调
                    String hexColor = picture.getPicColor();
                    // 没有主色调的图片放到最后
                    if (StrUtil.isBlank(hexColor)) {
                        return Double.MAX_VALUE;
                    }
                    // 将图片主色调转为 Color 对象
                    Color pictureColor = Color.decode(hexColor);
                    // 越大越相似，取负值是为了降序排列
                    return -ColorSimilarUtils.calculateSimilarity(targetColor, pictureColor);
                }))
                // 取前 12 个
                .limit(12)
                .collect(Collectors.toList());

        // 转换为 PictureVO
        // 将排序后的图片列表转换为 PictureVO 对象列表
        return sortedPictures.stream()
                .map(PictureVO::objToVo)
                .collect(Collectors.toList());
    }

    /**
     * todo 批量编辑图片
     *
     * @param pictureEditByBatchRequest 批量编辑图片的请求对象，包含要编辑的图片 ID 列表、空间 ID、分类和标签等信息
     * @param loginUser 当前登录的用户信息，用于权限验证
     */
    @Override
    @Transactional(rollbackFor = Exception.class)
    public void editPictureByBatch(PictureEditByBatchRequest pictureEditByBatchRequest, User loginUser) {
        // 从请求对象中获取要编辑的图片 ID 列表
        List<Long> pictureIdList = pictureEditByBatchRequest.getPictureIdList();
        // 从请求对象中获取图片所属的空间 ID
        Long spaceId = pictureEditByBatchRequest.getSpaceId();
        // 从请求对象中获取要设置的图片分类
        String category = pictureEditByBatchRequest.getCategory();
        // 从请求对象中获取要设置的图片标签列表
        List<String> tags = pictureEditByBatchRequest.getTags();

        // 1. 校验参数
        // 检查空间 ID 是否为空以及图片 ID 列表是否为空，如果是则抛出参数错误异常
        ThrowUtils.throwIf(spaceId == null || CollUtil.isEmpty(pictureIdList), ErrorCode.PARAMS_ERROR);
        // 检查当前登录用户是否为空，如果为空则抛出无权限错误异常
        ThrowUtils.throwIf(loginUser == null, ErrorCode.NO_AUTH_ERROR);
        // 2. 校验空间权限
        // 根据空间 ID 获取空间信息
        Space space = spaceService.getById(spaceId);
        // 检查空间是否存在，如果不存在则抛出未找到错误异常
        ThrowUtils.throwIf(space == null, ErrorCode.NOT_FOUND_ERROR, "空间不存在");
        // 检查当前登录用户是否有访问该空间的权限，如果没有则抛出无权限错误异常
        if (!loginUser.getId().equals(space.getUserId())) {
            throw new BusinessException(ErrorCode.NO_AUTH_ERROR, "没有空间访问权限");
        }

        // 3. 查询指定图片，仅选择需要的字段
        // 使用 LambdaQueryWrapper 查询指定空间下的指定图片，仅查询图片 ID 和空间 ID 字段
        List<Picture> pictureList = this.lambdaQuery()
                .select(Picture::getId, Picture::getSpaceId)
                .eq(Picture::getSpaceId, spaceId)
                .in(Picture::getId, pictureIdList)
                .list();

        // 如果查询结果为空，则直接返回
        if (pictureList.isEmpty()) {
            return;
        }
        // 4. 更新分类和标签
        // 遍历查询到的图片列表，更新图片的分类和标签
        pictureList.forEach(picture -> {
            // 如果分类不为空，则设置图片的分类
            if (StrUtil.isNotBlank(category)) {
                picture.setCategory(category);
            }
            // 如果标签列表不为空，则将标签列表转换为 JSON 字符串并设置到图片的标签字段
            if (CollUtil.isNotEmpty(tags)) {
                picture.setTags(JSONUtil.toJsonStr(tags));
            }
        });

        // 批量重命名
        String nameRule = pictureEditByBatchRequest.getNameRule();
        fillPictureWithNameRule(pictureList, nameRule);

        // 5. 批量更新
        // 批量更新图片信息
        boolean result = this.updateBatchById(pictureList);
        // 检查批量更新操作是否成功，如果失败则抛出操作错误异常
        ThrowUtils.throwIf(!result, ErrorCode.OPERATION_ERROR);
    }

    /**
     * todo:创建图片绘画任务——扩图
     *
     * @param createPictureOutPaintingTaskRequest 创建图片扩图任务的请求对象，包含创建任务所需的相关参数
     * @param loginUser 当前登录的用户信息，用于进行权限校验
     * @return 返回创建扩图任务的响应对象，包含任务创建的结果信息
     */
    @Override
    public CreateOutPaintingTaskResponse createPictureOutPaintingTask(CreatePictureOutPaintingTaskRequest createPictureOutPaintingTaskRequest, User loginUser) {
        // 获取图片信息
        // 从请求对象中获取要进行扩图的图片 ID
        Long pictureId = createPictureOutPaintingTaskRequest.getPictureId();
        // 根据图片 ID 从数据库中获取图片信息，如果图片不存在则抛出业务异常
        Picture picture = Optional.ofNullable(this.getById(pictureId))
                .orElseThrow(() -> new BusinessException(ErrorCode.NOT_FOUND_ERROR));
        // 权限校验
        // 检查当前登录用户是否有对该图片进行操作的权限
        checkPictureAuth(loginUser, picture);
        // 构造请求参数
        // 创建一个新的创建扩图任务的请求对象
        CreateOutPaintingTaskRequest taskRequest = new CreateOutPaintingTaskRequest();
        // 创建请求对象的输入参数对象
        CreateOutPaintingTaskRequest.Input input = new CreateOutPaintingTaskRequest.Input();
        // 设置输入参数的图片 URL 为要扩图的图片的 URL
        input.setImageUrl(picture.getUrl());
        // 将输入参数对象设置到任务请求对象中
        taskRequest.setInput(input);
        // 将传入的请求对象的属性复制到新创建的任务请求对象中
        BeanUtil.copyProperties(createPictureOutPaintingTaskRequest, taskRequest);
        // 创建任务
        // 调用阿里云 AI 接口创建扩图任务，并返回任务创建的响应对象
        return aliYunAiApi.createOutPaintingTask(taskRequest);
    }


    /**
     * todo:根据指定的命名规则填充图片名称
     * nameRule 格式：图片{序号}
     *
     * @param pictureList 要填充名称的图片列表
     * @param nameRule 图片命名规则，其中 "{序号}" 会被替换为从 1 开始递增的数字
     */
    private void fillPictureWithNameRule(List<Picture> pictureList, String nameRule) {
        // 检查图片列表是否为空或者命名规则是否为空，如果是则直接返回
        if (CollUtil.isEmpty(pictureList) || StrUtil.isBlank(nameRule)) {
            return;
        }
        // 初始化序号计数器，从 1 开始
        long count = 1;
        try {
            // 遍历图片列表
            for (Picture picture : pictureList) {
                // 将命名规则中的 "{序号}" 替换为当前的序号，并将结果作为图片的新名称
                String pictureName = nameRule.replaceAll("\\{序号}", String.valueOf(count++));
                // 设置图片的名称
                picture.setName(pictureName);
            }
        } catch (Exception e) {
            // 记录名称解析错误的日志
            log.error("名称解析错误", e);
            // 抛出业务异常，提示名称解析错误
            throw new BusinessException(ErrorCode.OPERATION_ERROR, "名称解析错误");
        }
    }


}




